package com.ruoyi.driver.service;

import org.json.JSONObject;
import org.springframework.stereotype.Service;

import java.util.Map;

/**
 * 人脸识别服务接口
 * @Author: Mr.xu
 * @Description: 百度云API人脸识别服务接口
 * @Date: 2025/8/26 18:31
 * @Version: 1.0
 */
public interface FaceRecognitionService {

    /**
     * 获取百度云API的访问Token
     * @return 访问Token
     */
    String getAuthToken();

    /**
     * 人脸检测（仅检测是否有人脸及质量）
     * @param imageBase64 人脸图片Base64编码
     * @return 检测结果JSON
     */
    JSONObject faceDetect(String imageBase64);

    /**
     * 人脸识别
     * 识别图片中的人脸并返回匹配的用户信息
     * @param imageBase64 人脸图片Base64编码
     * @return 识别结果Map，包含success、message、userInfo等字段
     */
    Map<String, Object> recognizeFace(String imageBase64);
    
    /**
     * 人脸注册
     * 将人脸图片注册到百度云人脸库中
     * @param imageBase64 人脸图片Base64编码
     * @param userId 用户ID，在本系统中使用司机ID
     * @param userName 用户名，在本系统中使用司机姓名
     * @return 注册结果Map，包含success和message字段
     */
    Map<String, Object> faceRegister(String imageBase64, String userId, String userName);
}
